package cn.com.dcsgo.validation;

import cn.com.dcsgo.validation.validator.ValueOfValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 自定义参数校验注解
 * 校验字段的值必须在指定的值列表中（校验字段为null时视为校验通过，如不允许为null请额外使用@NotNull修饰字段）
 * 支持常见的可以通过字面量进行赋值的对象如：Integer、Long、String等
 *
 * @author Dcsgo
 * @since 2025/10/12 15:46
 */
@Constraint(validatedBy = ValueOfValidator.class)
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValueOf {
    String[] value() default {};

    String message() default "${validatedValue}的值必须在{value}中";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};
}